<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>User Guide</title>
    <style>
        body { font-family: "Microsoft YaHei", sans-serif; padding: 20px; line-height: 1.6; }
        h2 { color: #2a6ebb; margin-top: 1.5em; }
        ul { margin-left: 1em; }
        a { color: #0077cc; text-decoration: none; }
        a:hover { text-decoration: underline; }
    </style>
</head>
<body>

<h1>📘 User Guide</h1>
<p>Welcome to this system! This guide provides a detailed introduction to the software’s features and usage methods.</p>

<h2>Contents</h2>
<ul>
    <li><a href="#start">1. Getting Started</a></li>
    <li><a href="#motor">2. Stage Settings</a></li>
    <li><a href="#source">3. Source Meter Settings</a></li>
    <li><a href="#storage">4. Storage & Image Settings</a></li>
    <li><a href="#scan">5. Scan Control</a></li>
    <li><a href="#export">6. Data & Image Export</a></li>
    <li><a href="#import">7. Data & Configuration Import</a></li>
    <li><a href="#faq">8. FAQ</a></li>
</ul>

<h2 id="start">1. Getting Started</h2>
<ol>
    <li>Open the software; the main interface will automatically attempt to connect to the motorized stage and source meter.</li>
    <li>Please confirm that the top-right corner indicates successful device connection.</li>
    <li>Click the <b>three buttons</b> in the top-left corner to enter <i>Stage Settings</i>, <i>Source Meter Settings</i>, and <i>Storage Settings</i> respectively.</li>
</ol>

<h2 id="motor">2. Stage Settings</h2>
<ul>
    <li>In “Settings → Stage Settings,” configure the X/Y axis start and end positions, speed, acceleration, and step size.</li>
    <li>Click “Read Current Position” to view the axis coordinates in real time.</li>
    <li>Click “Set as Start/End” to write the current coordinates into the configuration.</li>
    <li>Click the “Move” button to control displacement; hold “Continuous Move” for manual fine-tuning.</li>
    <li>Click “Homing” or “Manual Zero” to set the current axis to zero.</li>
</ul>

<h2 id="source">3. Source Meter Settings</h2>
<ul>
    <li>In “Settings → Source Meter Settings,” configure output voltage, current limit, number of samples, and sampling interval.</li>
    <li>Click “Connect” to connect the device; once connected successfully, you can apply parameters.</li>
    <li>Click “Apply” to save the configuration and immediately send it to the device (if connected).</li>
</ul>

<h2 id="storage">4. Storage & Image Settings</h2>
<ul>
    <li>Set the <b>Data Save Path</b> and <b>Image Save Path</b>.</li>
    <li>You can choose the data format (CSV, TXT, NPY, XLSX, etc.) and image format (PNG, SVG, PDF, etc.).</li>
    <li>Configure the colormap, interpolation method, and display range (vmin/vmax) for the image.</li>
    <li>Click the “Export Data” and “Export Image” buttons to manually save the current content.</li>
</ul>

<h2 id="scan">5. Scan Control</h2>
<ul>
    <li>After clicking “Start,” the system will automatically scan the set region and sample the current value.</li>
    <li>Click “Pause” to temporarily stop scanning, then click “Continue” to resume.</li>
    <li>Click “Stop” to end the current test.</li>
    <li>During operation, the right panel displays scan progress, current reading, and remaining time.</li>
</ul>

<h2 id="export">6. Data & Image Export</h2>
<ul>
    <li>Once scanning is complete, the system automatically exports <b>heatmap images</b> and <b>measurement data files</b>.</li>
    <li>You can manually perform “Export Data” and “Export Image” from the “File” menu.</li>
    <li>Each time you export data, the system also saves a copy of the current configuration (e.g. <code>_config.ini</code>).</li>
</ul>

<h2 id="import">7. Data & Configuration Import</h2>
<ul>
    <li>Click “File → Import Data” to load historical data and display the image.</li>
    <li>If there is a matching configuration file, the system will prompt whether to import the settings together.</li>
    <li>After importing incomplete scan data, the system enters “paused” state automatically; click “Continue” to resume scanning.</li>
    <li>Click “File → Import Configuration” to import another configuration file alone.</li>
</ul>

<h2 id="faq">8. FAQ</h2>
<ul>
    <li><b>Q: Why is the image not showing any colors?</b><br/>Check whether the vmin/vmax setting is appropriate. We recommend leaving them blank for auto-adjustment.</li>
    <li><b>Q: Unable to open the data file?</b><br/>Make sure to use the correct tool (e.g., Excel or Python) corresponding to the export format.</li>
    <li><b>Q: Configuration not taking effect?</b><br/>Please click “Apply” or reload the configuration before starting a test.</li>
</ul>

<hr/>
<p>If you need assistance, please contact the developer.</p>

</body>
</html>
